home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / golf / gms.zip / GMS.DOC < prev    next >
Text File  |  1988-05-19  |  15KB  |  353 lines
  1. GMS - Mean 18 (tm) Golf Management System - Release 1.0 
  2.  
  3. COPYRIGHT 1988 Dan Moore
  4.  
  5. GMS and its companion programs are Shareware.  They may be
  6. copied and distributed freely and if you find the programs
  7. useful, consider sending the author a contribution.  Please
  8. refer to the LICENSE.DOC file, distributed in this ARChive.
  9.  
  10.  
  11. WHAT IS GMS?
  12.  
  13. GMS consists of a single executable file (GMS.EXE), which
  14. should be copied to the same directory as Accolade's MEAN
  15. 18 game program (GOLF.EXE).  The program also assumes that
  16. the course files, saved games files, and Hall Of Fame files
  17. reside in the same directory as the MEAN 18 Game.  GMS is
  18. compatible with the M18Vxx program which creates .M10 files
  19. in order to mamage multiple courses beyond the game's
  20. original design criteria.  No specific installation or
  21. preparation steps are required for GMS, as long as course
  22. files have a .M10 or .M18 prefixes.
  23.  
  24. GMS displays MEAN 18 course, saved games, and Hall of Fame
  25. files in scrollable windows.  Course and saved game files
  26. may be selected for play/replay, and Hall Of Fame file
  27. contents may be displayed directly on the screen.   The
  28. maximum number of course files supported by GMS is only
  29. limited by available memory and the Microsoft QuickBasic
  30. 64K string space maximum.  A rough estimate is that on a
  31. 640K machine, GMS will support a total of 2100 directory
  32. entries (course+saved games+Hall Of Fame files).  Future
  33. versions of GMS will eliminate this limitation by using
  34. either EMS memory if available or store string data into
  35. numeric arrays (this would approximately triple the limit
  36. to about 6,400 files).
  37.  
  38.         
  39. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++OPERATIONS GUIDE
  40.  
  41. ========================================================== STARTING THE PROGRAM
  42.  
  43. Which MEAN18
  44.  
  45. There are two EGA versions of MEAN 18.  The pre-11/87
  46. version saves games in files with a .SAV suffix.  The
  47. post 11/87 version saves games in files with a .SVG suffix.
  48. .SAV files may be renamed to .SVG and may be used with the
  49. new games without harmful effects.  The main difference in the
  50. two game version is the addition of statistics functions
  51. (ie, longest drive, closest to pin, etc...).  The newer
  52. .SVG files contain game statistics; the older .SAV files do
  53. not.  GMS defaults to the newer .SVG  saved game files.  If
  54. you are using the older version of MEAN18, you should add
  55. the word "OLD" on the command line after the word "GMS" to
  56. force GMS to look for .SAV files instead.  If your game has
  57. a "Statistics" option between holes, you have the new game
  58. and need not worry.
  59.  
  60. To start GMS, type GMS at the DOS prompt (optionally
  61. followed by a space and OLD if you are using the older
  62. game).  GMS assumes that all GMS and MEAN 18-related files
  63. are in the current directory. This includes GOLF.EXE, all
  64. .M18 course files, .SAV saved gane files, and .HOF Hall Of
  65. Fame files.  If the GMSUTIL program is also used,
  66. GMSUTIL.EXE must be in the same directory (GMSUTIL has its
  67. own file requirements, documented in GMSUTIL.DOC). Upon
  68. startup, the program will display a generic welcome window
  69. and the names and dates of the last 10 courses played (the
  70. window will grow in size until 10 games have been played
  71. under GMS control, and the 10 most recent courses will be
  72. displayed from then on).  While that opening window is
  73. displayed, GMS is reading and file names.  The program will
  74. then display its standard operation screen, consisting of
  75. the three course selection windows, a help window at the
  76. bottom of the screen.  The top line of the screen shows a
  77. generic bar menu.
  78.  
  79. ============================================F1 KEY: SELECTING COURSES FOR PLAY
  80.  
  81. Pressing the F1 key will activate the course selection
  82. window.  The Menu Bar will be displayed in bright red (to
  83. match the color of the course window) with the menu text
  84. above the course window itself.  The names inside the
  85. course selection window are the ACTUAL course names stored
  86. inside the course files themselves, rather than the names
  87. of the course files (which may have little relationship
  88. with the real course names).  To select a course for play,
  89. scroll through the window with the Up/Dn/PgUp/PgDn keys.
  90. Note that the "page number" is displayed on the top right
  91. of the window and changes as you scroll through the list of
  92. course names.  The selected course name will appear in
  93. bright white letters on a bright red background.  To play a
  94. desired course, cursor to its name and press <Enter>.
  95. Control will be passed to the MEAN 18 game program.  When
  96. you are asked to insert your course disk, press <Enter> and
  97. the game will display the name of the selected course in
  98. the provided window.  You're in business. 
  99.  
  100.  
  101. After you end the game, GMS will regain control and will
  102. display a "Course Comment" window.  You may type a
  103. 64-character comment on the course you just played, and
  104. press <Enter> to save it in the course information file.
  105. Pressing <Esc> will bypass the course comment process.  If
  106. a comment for this course already exist, it will be
  107. displayed and can be edited and saved.  While typing the
  108. comment, the following editing keys are available:
  109.  
  110. INS             toggle insert/overstrike mode (cursor change)
  111. DEL             delete character at cursor
  112. <left>          move cursor left one space
  113. <right>         move cursor right one space
  114. Ctrl-<left>     move cursor left one word
  115. Ctrl-<right>    move cursor right one word
  116. <Backspace>     destructive backspace
  117. <Home>          move to start of field
  118. <End>           move to end of field
  119. Ctrl-<End>      delete to end of field
  120.  
  121.  
  122. After exitting the comment window, GMS will immediately
  123. re-read the directory to reflect Saved Game or Hall Of
  124. Fame files created or updated as a result of the last game.
  125. Note that the menu bar has been disabled.  This was done to
  126. prevent overzealous players from hitting <Enter> a little
  127. too fast and starting a game they didn't want.
  128.  
  129. NOTE: If you ended the game normally, but did not create a
  130. new Hall Of Fame entry, or quit the game without saving it,
  131. the file directories will not be updated and you will be
  132. returned to GMS immediately.  This will save a few seconds
  133. on slower systems of systems with large number of saved
  134. games or Hall Of Fame files.
  135.  
  136. =========================================F2 KEY: SELECTING SAVED GAMES FOR PLAY
  137.  
  138. Pressing the F2 Key will activate the Saved Game window.
  139. There are no operational differences between the Course and
  140. Saved Game selection process.  The saved game window is
  141. there to let you know that a game has been saved for a
  142. given course.  In this respect, GMS is a bit smarter than
  143. MEAN 18 itself.  The game allows you to ask for a saved
  144. game, even though none may exist.
  145.  
  146. NOTE: You may notice file names followed by asterisks in
  147. the Saved Game window (ie,  AUGUSTA**********).  This
  148. indicates that although a saved game was found, the Course
  149. File itself was not.  These courses may not be selected for
  150. play.  This may be a frequent condition if you are using
  151. the GMSUTIL program, which allows you to store course files
  152. in ARChived (compressed) format.  If you attempt to select
  153. one of these courses, GMS will beep and nothing will occur.
  154. If the course file was ARCed, you may transfer control to
  155. GMSUTIL by pressing the F5 key.  Within GMSUTIL you may
  156. un-ARC the desired course file and return to GMS by
  157. pressing the F9 key.
  158.  
  159. ==========================================F3 KEY: DISPLAYING HALL-OF-FAME FILES
  160.  
  161. Pressing the F3 Key will activate the Hall Of Fame window.
  162. The Hall Of Fame window contains the names of the courses
  163. for which Hall Of Fame files have been created (A Hall of
  164. Fame entry will be created if your score was under 100 and
  165. you earned one of the top 10 scores for that course).
  166. Pressing <Enter> will  display the Hall Of Fame file in a
  167. new window in the center of the screen.  To clear this
  168. window, press one of the GMS function keys (F1-F5)
  169.  
  170. NOTE: You may notice file names followed by asterisks in
  171. the Hall Of Fame window (AUGUSTA***********).  This
  172. indicates that although a Hall Of Fame file was found, the
  173. Course File itself was not.  This is not a problem, and
  174. these Hall Of Fame files can still be displayed if
  175. selected. This may be a frequent condition if you are using
  176. the GMSUTIL program, which allows you to store course files
  177. in ARChived (compressed) format.
  178.  
  179. ===============================================F4 DISPLAYING COURSE INFORMATION
  180.  
  181. Pressing the F4 key will display a course information
  182. prompt window asking for the name of a course or course
  183. file, or course information data to be searched.  For each
  184. course which has been played under GMS, the Course Information
  185. file contains the course name, the course file name, the last
  186. date the course was selected for play, and the comments you
  187. may have entered after playing the game.  You may enter a
  188. complete or partial course name or file name or information
  189. search string and GMS will search the course information
  190. file for a match.  If no match is found for the specified
  191. search string, a message to that effect will be displayed.
  192.  
  193. If a match is found, you may press <Enter> to search the
  194. file for the next match (the same search argument may be
  195. found in a number of courses).  Pressing <esc> cancels the
  196. request.
  197.  
  198. If the course information file is not found, GMS will beep
  199. when the F4 key is pressed.  The course information file
  200. (COURSES.DAT) is created after the first game is played and
  201. is updated after each subsequent game.
  202.  
  203. ===========================================F5 KEY: INVOKING THE GMSUTIL PROGRAM
  204.  
  205. Pressing the F5 key will immediately transfer control to
  206. the GMSUTIL program.  For more information on GMSUTIL,
  207. refer to the GMSUTIL.DOC file.  If you are running MEAN 18
  208. on a hard disk, you really owe it to yourself and your
  209. pocketbook to use GMSUTIL.
  210.  
  211. =============================================================F6 KEY: ENDING GMS
  212.  
  213. Pressing the F5 key will immediately and irreversibly
  214. terminate GMS and return control to DOS.
  215.  
  216. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++END OF OPERATIONS GUIDE
  217.  
  218. GMS ERRORS
  219.  
  220. If GMS detects an unrecoverable file error, the program
  221. will terminate summarily and display an appropriate message
  222. containing two error codes: the GMS error code which tells
  223. at which point in the program the error was encountered,
  224. and the DOS/BIOS error code which was returned by the
  225. system.  Following is a description of all GMS error codes,
  226. the conditions which cause them, and possible solutions.
  227.  
  228. Error code 1  UNABLE TO OPEN HOF FILE
  229.         You have problems.  The file was found in the disk
  230.         directory, but cannot be opened for input to read HOF
  231.         statistics. The DOS error code should tell you what is wrong.
  232.         Possible: bad disk, bad directory, file was erased somehow.
  233.  
  234. Error Code 2 UNABLE TO READ HOF FILE
  235.         You have problems.  See DOS error code.
  236.  
  237. Error Code 3,5,7 UNABLE TO OPEN LAST10.DAT FILE 
  238.         Similar to error 1, but with last 10 game file
  239.  
  240. Error Code 4,6 UNABLE TO READ LAST10.DAT FILE 
  241.         Similar to error 2.
  242.  
  243. Error Code 8 UNABLE TO CREATE LAST10.DAT FILE
  244.         You may be completely out of disk space, bad disk,
  245.         or write-protected disk.
  246.  
  247. Error Code 9 UNABLE TO WRITE LAST10.DAT file
  248.         Similar to error 8
  249.  
  250. Error Code 11 UNABLE TO OPEN COURSE FILE
  251.         Similar to error 1
  252.  
  253. Error Code 12 UNABLE TO RENAME .M18 FILE
  254.         Most likely cause: You have TWO course files, one
  255.         with a .M10 and one with a .M18 extension, but the
  256.         same name.  Erase the .M18 file.
  257.        
  258.  
  259. THE GMSUTIL PROGRAM
  260.  
  261. If you use a hard disk, I strongly recommend that you use
  262. GMSUTIL, GMS' companion program, and which is distributed
  263. with GMS.  GMSUTIL allows you to keep course files in
  264. compressed format and can save you tons of expensive hard
  265. disk space.
  266.  
  267.  
  268. REQUIREMENTS
  269.  
  270. GMS should run in a PC or AT-compatible computer with
  271. PC/MS-DOS release 2.1 or higher.  Exact memory requirements
  272. have not been determined, but it runs fine in a 640k AT
  273. with PCDOS 3.3 and about 40k worth of Terminate-Stay
  274. Resident (TSR) programs, environment space, buffers, FCBs,
  275. and device drivers.  Of course, GMS requires a color
  276. display.  GMS transfers control to the MEAN 18 game when a
  277. course is selected and itself remains in the background,
  278. occupying memory.
  279.  
  280.  
  281. TECHNICAL DEPARTMENT
  282.  
  283. GMS was developed and tested on a PC-AT clone with 640k of
  284. memory running PC-DOS 3.3 and equipped with a clone EGA
  285. card and display.  The program consists of approximately
  286. 900 lines of QuickBasic 3.0 code. The program makes
  287. extensive use of Hamerly Computer Services ProBas (a
  288. library of routines for QuickBasic) for directory and file
  289. accesses as well as screen displays, windowing, and input
  290. routines.
  291.  
  292. The excellent and very fast QuickSort routine used to sort
  293. the course name arrays was originally released 3/82 by W.
  294. Pickett, and modified 7/87 for Turbo Basic by A. S. Kuiper.
  295. I modified it 9/87 for use under QuickBasic 3.0.
  296.  
  297.  
  298. WHERE TO REACH ME
  299.  
  300. I may be reached on the following EXCELLENT Bulletin Board
  301. Systems (in alphabetical order):
  302.  
  303. Executive Network, Mt. Vernon, NY - Andy Keeves, Sysop
  304. Forbin Project, Cedar Falls, IA - John Friel III, Sysop
  305. LANS, Gary, IN. - Phillip Stults, Sysop 
  306. Lestershire Country Club, Turnersville, NJ - Jim Collinge, Sysop
  307. Professionals' Choice, Indianapolis, IN - Bob Predaina, Sysop
  308.  
  309.  
  310. ACKNOWLEDGEMENTS
  311.  
  312. I would like to thank the following people who provided me
  313. a lot of constructive feedback on GMS and GMSUTIL:
  314.  
  315. Mark McHolland, a golf addict, co-worker, and all-around
  316. nice guy.  Not long  after he installed his new, shiny AT
  317. computer with the fast 40 meg hard disk, it was 30% full
  318. with MEAN 18 course files.  It was with Mark in mind that I
  319. wrote GMSUTIL.  By far, Mark provided me with the best
  320. feedback and constructive criticism on all these programs.
  321. Armed with GMSUTIL, ARCH.EXE, and a Microsoft mouse, Mark
  322. has also been a very prolific MEAN 18 course Architect.
  323.  
  324. Dave Lacey, a friend of Mark and also co-worker, whom I
  325. sent into tailspins when I made a small, insignificant
  326. change to GMS which prevented it from working on CGA
  327. systems.  With his overfilled 20meg HD, Dave needed GMSUTIL
  328. a lot worse than Mark or I.
  329.  
  330. Phil Stults, Sysop of the LANS BBS in Gary, IN., friend,
  331. attorney, golfer, gentleman and scholar.  Phil is the only
  332. man in the civilized world with a true blue IBM 64K EGA
  333. card.  Please send in these contributions so I can buy Phil
  334. a real EGA with 256K for his next birthday, which I will
  335. deliver in the Lamborghini, of course.
  336.  
  337. Jim Collinge, Sysop of the Lestershire Country Club BBS in
  338. Turnersville, NJ, another golfer, gentleman and scholar.
  339. Jim got hooked on MEAN 18 very quickly and he may well be
  340. the first sysop to have produced a course (LCCMEAN) with
  341. the same name as his bulletin board (a darn good course).
  342.  
  343. As it should be, LANS and LCC were be the first two BBSs
  344. with the production release of GMS.
  345.  
  346.  
  347. Dan Moore
  348. 1514 South Drive
  349. Columbus, IN 47203
  350.  
  351.  
  352. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++END OF GMS.DOCGMSUTIL.DOC
  353.